This release note and the software that accompanies it are copyright (c) 2003, Intel Corporation, and may only be installed and used in accordance with the license that accompanies the software.

File name: gdth_dvr_205.zip

Driver version 2.05


This download supports the following Intel(R) Server RAID Controllers:
*SRCS14L

This download supports SATA Intel(R) Server RAID Controllers, please verify that this driver has been tested with the RAID controller you have chosen to use.
You can verify compatability on the RAID controller's driver page at http://support.intel.com.


This download is packaged as a zip file and can be unzipped using a variety of compatible zip programs.


The contents of this download are governed by the terms and conditions as laid out by 
the file COPYING.

The file gdth.tgz is a tar-zipped file containg driver source code taken from the Linux kernel.
Untar and unzip the file and copy contents to: /usr/src/linux/drivers/scsi and recompile
the kernel.


Attention!
===========
This program will extract a copy the gdth RAID driver set to a floppy diskette.  
These files are provided for your convenience, however no support is provided.  Because these files can be used with a variety of Linux versions,
Please refer your specifice product and OS documentation for application instructions for this driver.
 

Contents
=========

File			Version 	Size		Date         	Description		
-----			--------     	----- 		-----        	------------
Copying			n/a		18KB		10/16/02	
gdth.tgz		2.05		53KB		10/16/02	Driver
GDTH README.TXT		n/a	       	2KB	   	10/22/02	This file


Using This Tool
================
1. Extract the download files to a floppy diskette.
2. Installing/Upgrading gdth Drivers
    =================================

Requirements:
------------
	1. Please make sure you have installed Linux kernel sources
	   for the running Linux kernel.
	2. Make sure you have all the required development tools
	   necessary to recompile the Linux Kernel.
	
If the driver version of the installed drivers are lower than the ones
supplied here, please upgrade your drivers. This can be done by following
either of the two steps.

1. Use the file "gdth.bin"
	 The file "gdth.bin" is a self extracting executable to compile 
   GDTH driver as linux kernel module for the ruuning kernel. If your 
   existing drivers are kernel modules, this method might be the easiest 
   way to update them. 
   a) If the file "gdth.bin" is not executable then make it executable using
      the following command: "chmod +x gdth.bin"
   b) Simply run the file with the command "./gdth.bin" and follow prompts.

2. Use the file "gdth.tgz:
	You will need access to source files of the Linux kernel running on
   your system. Assumming that the kernel source code is installed at 
   /usr/src/linux, do the following:
   a) Untar and unzip the file and copy contents to: /usr/src/linux/drivers/scsi
   b) Recompile the kernel. For more information on recompiling the kernel,
      please read documentation under the /usr/src/linux/Documentation
      directory.
   c) Install the newly built kernel and modules. Note you might have to make
      changes to your Boot loader configuration to activate the new kernel.
      Please refer to the documentation supplied with your Linux distribution.

_______________________________________________________________________

III) Using gdth drivers
     ==================

A) gdth driver parameters
-------------------------

Driver versions older than 1.05 do not support driver parameters.
From driver version 1.05 to 1.07 it is necessary to add driver parameters
directly in /usr/src/linux/drivers/scsi/gdth.c . From version 1.10 on you may
use for the parameters the LILO boot prompt (gdth=...") or in /etc/lilo.conf
the append command (append = "gdth=...").

Reservation of SCSI devices:
---------------------------
    The reservation of SCSI devices becomes necessary if you wish that so-called 
'Direct Access Devices' (e.g. hard disks, removable hard disks like IOMEGA or
SyQuest, some MOs) are directly controlled by Linux and not the Storage RAID
Controller's firmware (i.e., they are not configured as Host Drives). This is
also called "raw-service". In this case the Storage RAID Controller does not 
cache the data to/from the reserved SCSI device. This reservation is important for
removable hard disks. If they are controlled by the Storage RAID Controller and are
a Host Drive, a media change is very difficult. 'Non Direct Access Devices' like
CD-ROMs, Streamers, DATs, etc. do NOT require a reservation.

IMPORTANT: The reservation is only possible with uninitialized SCSI devices.
(Use Storcon utility to de-initialize an already initialized device).

As already mentioned a reservation for driver versions 1.05 to 1.07 has to be
made directly in the driver sources. Look for 'gdth_reserve_str' in  
'/usr/src/linux/drivers/scsi/gdth.c' . You'll find a non-active sample entry,
which you can change according to the coordinates of the device you want to
reserve (enter Adapter, Bus, ID and LUN). Save the file and compile a new
kernel.

From driver version 1.10 on you can add the parameters for the reservation
with the LILO append command:

Excerpt of a sample /etc/lilo.conf:
-----------------------------------
# End LILO global section
# Linux bootable partition config begins
image = /boot/vmlinuz
root = /dev/sda2
label = Linux
append = "gdth=reserve_list:1,0,6,0"
# Linux bootable partition config ends

This gdth driver parameter reserves the SCSI device which is connected with
Storage RAID Controller 1 (second Storage RAID Controller), SCSI Bus 0 (channel A),
ID 6, LUN 0 for Linux (raw service).

Note: After each change in /etc/lilo.conf , lilo must be rerun to activate the
changes.
Note: Driver parameters may also be entered at the LILO boot prompt.
(e.g.: gdth=reserve_list:1,0,6,0).


Further driver parameters:
-------------------------

irq1,irq2, etc.                  Only for Storage RAID EISA Controllers with disabled
                                 BIOS (irq1, irq2, etc. correspond with the
                                 IRQs of the Storage RAID Controllers)
disable:Y                        deactivates the Storage RAID driver
disable:N                        activates the Storage RAID driver
reserve_mode:0                   reserves no SCSI devices [*1]
reserve_mode:1                   reserves all not-initialized removable
                                 hard disk [*1]
reserve_mode:2                   reserves all not-initialized SCSI devices [*1]
reserve_list:h,b,t,l,h,b,t,l,... reserves SCSI devices at the corresponding
                                 coordinates with
                                 h=Hostadapter, b=SCSI Bus, t=Target ID, l=LUN
reverse_scan:Y                   reversed scanning order of the PCI controllers
reverse_scan:N                   normal scanning order of PCI Controllers
                                 according to the system BIOS
max_ids:x                        x = number of target IDs per SCSI channel
                                 (accelerates the boot process)
rescan:Y                         rescan all SCSI channels / IDs
rescan:N                         scan only those SCSI devices found during
                                 system power up [*1]

[*1] The driver parameters reserve_mode and rescan:N require Storage RAID Controllers
with firmware version FW 1.23.00/2.23.00 or higher.

The current default settings of the driver are:

"gdth=disable:N,reserve_mode:1,reverse_scan:N,max_ids:127,rescan:N"

If gdth is loaded as a module, these parameters can also be added with
a special syntax.
IRQ parameters are entered as 'IRQ=' (e.g. IRQ=10). Several parameters
are not separated with a comma (',') but a space (' ').
All ':' are substituted with '=', all 'Y' with '1' and all 'N' with '0'.

Default: "modprobe gdth disable=0 reserve_mode=1 reverse_scan=0 
 max_ids=127 rescan=0"


B) Further interesting information:
-----------------------------------

/proc-Support:

Read of /proc/scsi/gdth/0, /proc/scsi/gdth/1, .. :
Displays the Storage RAID Controller/SCSI busses, firmware version, driver version
(e.g.: cat /proc/scsi/gdth/0)

Write to /proc/scsi/gdth/0, .. :
    gdth flush          Flush all Host Drives of the Storage RAID Controller
    gdth flush drive    Flush the Host Drive with the number drive
    gdth wbp_off        Disable Write-Back permanently
    gdth wbp_on         Enable Write-Back permanently 
    gdth wb_off         Disable Write-Back for this session
                        (from Firmware version 1.15/2.15)
    gdth wb_on          Enable Write-Back for this session
                        (from Firmware version 1.15/2.15)


###################################################################################





